<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>systemd.swap
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>systemd.swap 中文手册</h1><h2 id="auth_name">译者：<strong><a href="../index.html">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="../index.html">金步国作品集</a> [ <a href="../index.html">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="systemd.swap"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>systemd.swap — swap单元配置</p></div><div class="refsynopsisdiv"><h2>大纲</h2><p><code class="filename"><em class="replaceable"><code>swap</code></em>.swap</code></p></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p>以
    "<code class="literal">.swap</code>" 为后缀的单元文件，
    封装了一个由 systemd 管理的
    swap设备或swap文件。</p><p>本手册列出了所有
    专用于此类单元的配置选项(亦称"配置指令"或"单元属性")。
    <a href="systemd.unit.html#"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>
    中描述了通用于所有单元类型的配置选项，
    它们位于 [Unit] 与 
    [Install] 小节。
    此类单元专用的配置选项位于 [Swap] 小节。</p><p>其他相关的选项还包括：
    <a href="systemd.exec.html#"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>
    中的选项定义了 <a href="http://man7.org/linux/man-pages/man8/swapon.8.html"><span class="citerefentry"><span class="refentrytitle">swapon</span>(8)</span></a>
    程序的执行环境；
    <a href="systemd.kill.html#"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a>
    中的选项
    定义了进程的结束方式；
    <a href="systemd.resource-control.html#"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a>
    中的选项
    定义了进程的资源限制。</p><p>swap 单元的名称必须根据其封装的swap设备或swap文件的路径命名。例如 <code class="filename">/dev/sda5</code> 设备对应的单元名称必须是 <code class="filename">dev-sda5.swap</code> 。
    有关路径名转换到单元名的细节，参见
    <a href="systemd.unit.html#"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a> 手册。
    注意，swap 单元不能从模版实例化而来，
    也不能通过创建软连接的方法给同一个 swap 单元赋予多个别名。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="自动依赖">自动依赖<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E8%87%AA%E5%8A%A8%E4%BE%9D%E8%B5%96">¶</a></h2><div class="refsect2"><a name="id-1.6.2"></a><h3 id="隐含依赖">隐含依赖<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E9%9A%90%E5%90%AB%E4%BE%9D%E8%B5%96">¶</a></h3><p>下列依赖关系是自动隐含的：</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>所有 swap 单元都将自动获得对所依赖的底层块设备单元或挂载点单元的
        <code class="varname">BindsTo=</code> 与 <code class="varname">After=</code>
        依赖
        。</p></li></ul></div><p>其他与执行环境以及资源控制有关的自动依赖关系
      参见
      <a href="systemd.exec.html#"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>
      与
      <a href="systemd.resource-control.html#"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a> 手册。</p></div><div class="refsect2"><a name="id-1.6.3"></a><h3 id="默认依赖">默认依赖<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E9%BB%98%E8%AE%A4%E4%BE%9D%E8%B5%96">¶</a></h3><p>除非明确设置了 <code class="varname">DefaultDependencies=no</code> ，否则 swap 单元将会自动添加下列依赖关系：</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>(1)自动获得 <code class="varname">Conflicts=umount.target</code> 与
        <code class="varname">Before=umount.target</code> 依赖，以确保在关机前完成卸载；
        (2)自动获得 <code class="varname">Before=swap.target</code> 依赖，以确保在系统初始化完成之前完成挂载。</p></li></ul></div></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="fstab"><code class="filename">fstab</code><a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#fstab">¶</a></h2><p>swap 单元既可以通过单元文件进行配置，也可以通过
    <code class="filename">/etc/fstab</code> 文件(参见
    <a href="http://man7.org/linux/man-pages/man5/fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a>
    手册)进行配置。<code class="filename">/etc/fstab</code>
    中的swap项将在每次重新加载 systemd 配置时(包括系统启动时)动态的自动转化为 swap 单元。
    一般来说，<code class="filename">/etc/fstab</code> 文件是配置 swap 单元的首选方法，详见
    <a href="systemd-fstab-generator.html#"><span class="citerefentry"><span class="refentrytitle">systemd-fstab-generator</span>(8)</span></a>
    手册。</p><p>如果某个 swap 项既配置在了
    <code class="filename">/etc/fstab</code> 文件中，又配置在了 swap 单元中，
    那么以 swap 单元为准。</p><p>可以在 <code class="filename">/etc/fstab</code> 中
    使用一些无法被其他程序识别的 systemd 专用挂载选项，
    以帮助创建 swap 单元的依赖关系。</p><div class="variablelist"><dl class="variablelist"><dt id="noauto"><span class="term"><code class="option">noauto</code>, </span><span class="term"><code class="option">auto</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#noauto">¶</a></dt><dd><p> <code class="option">noauto</code> 表示
        不将此 swap 单元加入到
        <code class="filename">swap.target</code> 的依赖中，
        也就是不在系统启动时自动挂载(除非为了满足其他单元的依赖而被挂载)。
         <code class="option">auto</code>(默认值) 表示自动将此 swap 单元加入到 <code class="filename">swap.target</code> 的依赖中，
        也就是在系统启动时自动挂载。</p></dd><dt id="nofail"><span class="term"><code class="option">nofail</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#nofail">¶</a></dt><dd><p> <code class="option">nofail</code> 表示
        仅在
        <code class="filename">swap.target</code>
        中对此挂载点使用 Wants= 依赖(而不是默认的 Requires=)。
        也就是即使此swap项挂载失败，也不会中断系统的启动流程。</p></dd><dt id="x-systemd.device-timeout="><span class="term"><code class="option">x-systemd.device-timeout=</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#x-systemd.device-timeout=">¶</a></dt><dd><p>设置等候所依赖的设备进入可用状态的最大时长，
        若超时则放弃挂载。
        可以使用 
        "<code class="literal">ms</code>", "<code class="literal">s</code>",
        "<code class="literal">min</code>", "<code class="literal">h</code>" 这样的时间单位后缀。
        若省略后缀则表示单位是秒。</p><p>注意，此选项仅可用于 
        <code class="filename">/etc/fstab</code> 文件，
        不可用于单元文件中的 <code class="varname">Options=</code>
        选项。</p></dd><dt id="x-systemd.makefs"><span class="term"><code class="option">x-systemd.makefs</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#x-systemd.makefs">¶</a></dt><dd><p>在该设备上重建 swap 结构(格式化)。
        如果此设备"非空"(已含有签名)，那么将会跳过格式化操作。
        因此，此选项可以安全的应用于已格式化的设备。</p><p>此选项仅可用于 <code class="filename">/etc/fstab</code> 文件，
        不可用于单元文件中的 <code class="varname">Options=</code> 选项。</p><p>参见
        <a href="http://www.jinbuguo.com/systemd/systemd-mkswap@.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-mkswap@.service</span>(8)</span></a>
        手册，以及对
        <a href="http://man7.org/linux/man-pages/man8/wipefs.8.html"><span class="citerefentry"><span class="refentrytitle">wipefs</span>(8)</span></a>
        的讨论(参见 <a href="systemd.mount.html#"><span class="citerefentry"><span class="refentrytitle">systemd.mount</span>(5)</span></a> 手册)。
        </p></dd></dl></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>每个 swap 单元文件都必须包含一个 [Swap] 小节，
    用于包含该单元封装的swap设备或swap文件的各项信息。
    可在 [Swap] 小节中使用的选项，
    有许多是与其他单元共享的，详见
    <a href="systemd.exec.html#"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>
    与
    <a href="systemd.kill.html#"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a>
    手册。这里只列出仅能用于 [Swap] 小节的选项
    (亦称"指令"或"属性")：</p><div class="variablelist"><dl class="variablelist"><dt id="What="><span class="term"><code class="varname">What=</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#What=">¶</a></dt><dd><p>绝对路径形式表示的swap设备节点或swap文件，
        详见 <a href="http://man7.org/linux/man-pages/man8/swapon.8.html"><span class="citerefentry"><span class="refentrytitle">swapon</span>(8)</span></a> 手册。
        如果是一个swap设备节点，那么将会自动添加对此设备节点单元的依赖，
        参见 <a href="systemd.device.html#"><span class="citerefentry"><span class="refentrytitle">systemd.device</span>(5)</span></a> 手册。
        如果是一个swap文件，那么将会自动添加对此文件所属挂载点的依赖，
        参见 <a href="systemd.mount.html#"><span class="citerefentry"><span class="refentrytitle">systemd.mount</span>(5)</span></a> 手册。
        这是一个必需的设置。
        注意，因为可以在此选项中使用 "<code class="literal">%</code>" 系列替换标记，
        所以百分号(%)应该使用 "<code class="literal">%%</code>" 表示。</p></dd><dt id="Priority="><span class="term"><code class="varname">Priority=</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#Priority=">¶</a></dt><dd><p>设置此swap项的优先级，
        必须设为一个整数。这是一个可选的设置。
        如果已经在 <code class="varname">Options=</code> 中使用 <code class="option">pri=</code> 设置了优先级，
        那么将忽略此处的设置。</p></dd><dt id="Options="><span class="term"><code class="varname">Options=</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#Options=">¶</a></dt><dd><p>一组逗号分隔的挂载选项(例如"discard"之类)。
        这是一个可选的设置。
        详见 <a href="http://man7.org/linux/man-pages/man8/swapon.8.html"><span class="citerefentry"><span class="refentrytitle">swapon</span>(8)</span></a> 手册。
        注意，因为可以在此选项中使用 "<code class="literal">%</code>" 系列替换标记，
        所以百分号(%)应该使用 "<code class="literal">%%</code>" 表示。</p></dd><dt id="TimeoutSec="><span class="term"><code class="varname">TimeoutSec=</code></span><a class="headerlink" title="Permalink to this term" href="systemd.swap.html#TimeoutSec=">¶</a></dt><dd><p>最大允许使用多长时间以完成挂载(swapon)动作。
        若超时则被视为挂载失败，
        并且所有当前正在运行的命令
        都将被以 <code class="constant">SIGTERM</code> 信号终止；
        若继续等待相同的时长之后命令仍未终止，
        那么将使用 <code class="constant">SIGKILL</code> 信号强制终止(详见
        <code class="option">KillMode=</code> 选项[参见
        <a href="systemd.kill.html#"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a> 手册])。
        可以使用 "ms", "s", "min", "h" 这样的时间单位后缀。
        若省略时间单位后缀则单位是秒。设为 "<code class="literal">0</code>" 表示永不超时。
        默认值为
        <code class="varname">DefaultTimeoutStartSec=</code>
        选项的值(参见
        <a href="systemd-system.conf.html#"><span class="citerefentry"><span class="refentrytitle">systemd-system.conf</span>(5)</span></a> 手册)。
        </p></dd></dl></div><p>参见
    <a href="systemd.exec.html#"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>
    与
    <a href="systemd.kill.html#"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a>
    以了解更多设置。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="systemd.swap.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
        <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
        <a href="systemctl.html#"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
        <a href="systemd-system.conf.html#"><span class="citerefentry"><span class="refentrytitle">systemd-system.conf</span>(5)</span></a>,
        <a href="systemd.unit.html#"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>,
        <a href="systemd.exec.html#"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>,
        <a href="systemd.kill.html#"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a>,
        <a href="systemd.resource-control.html#"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a>,
        <a href="systemd.device.html#"><span class="citerefentry"><span class="refentrytitle">systemd.device</span>(5)</span></a>,
        <a href="systemd.mount.html#"><span class="citerefentry"><span class="refentrytitle">systemd.mount</span>(5)</span></a>,
        <a href="http://man7.org/linux/man-pages/man8/swapon.8.html"><span class="citerefentry"><span class="refentrytitle">swapon</span>(8)</span></a>,
        <a href="systemd-fstab-generator.html#"><span class="citerefentry"><span class="refentrytitle">systemd-fstab-generator</span>(8)</span></a>,
        <a href="systemd.directives.html#"><span class="citerefentry"><span class="refentrytitle">systemd.directives</span>(7)</span></a>
      </p></div></div></body></html>
